home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.n / frame.n < prev    next >
Text File  |  1995-07-25  |  8KB  |  198 lines
  1.  
  2.  
  3.  
  4.      ffffrrrraaaammmmeeee((((nnnn))))                     TTTTkkkk (((( ))))                      ffffrrrraaaammmmeeee((((nnnn))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           frame - Create and manipulate frame widgets
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ffffrrrraaaammmmeeee _p_a_t_h_N_a_m_e ?----ccccllllaaaassssssss _c_l_a_s_s_N_a_m_e? ?_o_p_t_i_o_n_s?
  15.  
  16.      SSSSTTTTAAAANNNNDDDDAAAARRRRDDDD OOOOPPPPTTTTIIIIOOOONNNNSSSS
  17.           bbbbaaaacccckkkkggggrrrroooouuuunnnndddd      ccccuuuurrrrssssoooorrrr         rrrreeeelllliiiieeeeffff                         |
  18.           bbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh     ggggeeeeoooommmmeeeettttrrrryyyy
  19.  
  20.           See the ``options'' manual entry for details on the standard
  21.           options.
  22.  
  23.      WWWWIIIIDDDDGGGGEEEETTTT----SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC OOOOPPPPTTTTIIIIOOOONNNNSSSS
  24.           Name:           hhhheeeeiiiigggghhhhtttt                                        |
  25.           Class:          HHHHeeeeiiiigggghhhhtttt                                        |
  26.           Command-Line Switch:           ----hhhheeeeiiiigggghhhhtttt                        |
  27.  
  28.                                                                              ||
  29.                Specifies  the  desired height for the window in any of  |
  30.                the forms acceptable to TTTTkkkk____GGGGeeeettttPPPPiiiixxxxeeeellllssss.  This  option  is  |
  31.                only  used  if the ----ggggeeeeoooommmmeeeettttrrrryyyy option is unspecified.  If  |
  32.                this  option  is  less  than  or  equal  to  zero  (and  |
  33.                ----ggggeeeeoooommmmeeeettttrrrryyyy  is  not  specified) then the window will not  |
  34.                request any size at all.                                 |
  35.  
  36.           Name:           wwwwiiiiddddtttthhhh                                         |
  37.           Class:          WWWWiiiiddddtttthhhh                                         |
  38.           Command-Line Switch:           ----wwwwiiiiddddtttthhhh                         |
  39.  
  40.                                                                              ||
  41.                Specifies  the  desired  width for the window in any of  |
  42.                the forms acceptable to TTTTkkkk____GGGGeeeettttPPPPiiiixxxxeeeellllssss.  This  option  is  |
  43.                only  used  if the ----ggggeeeeoooommmmeeeettttrrrryyyy option is unspecified.  If  |
  44.                this  option  is  less  than  or  equal  to  zero  (and  |
  45.                ----ggggeeeeoooommmmeeeettttrrrryyyy  is  not  specified) then the window will not  |
  46.                request any size at all.
  47.      _________________________________________________________________
  48.  
  49.  
  50.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  51.           The ffffrrrraaaammmmeeee  command  creates  a  new  window  (given  by  the
  52.           _p_a_t_h_N_a_m_e  argument)  and  makes  it  into  a  frame  widget.
  53.           Additional options, described above, may be specified on the
  54.           command  line or in the option database to configure aspects
  55.           of the frame such as its background color and  relief.   The
  56.           ffffrrrraaaammmmeeee command returns the path name of the new window.
  57.  
  58.           A frame is a simple widget.  Its primary purpose is  to  act
  59.           as  a  spacer  or container for complex window layouts.  The
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ffffrrrraaaammmmeeee((((nnnn))))                     TTTTkkkk (((( ))))                      ffffrrrraaaammmmeeee((((nnnn))))
  71.  
  72.  
  73.  
  74.           only features of a frame are its  background  color  and  an
  75.           optional  3-D  border  to  make  the  frame appear raised or
  76.           sunken.
  77.  
  78.           In addition to the standard options listed above,  a  ----ccccllllaaaassssssss
  79.           option  may  be  specified  on  the  command line.  If it is
  80.           specified, then the  new  widget's  class  will  be  set  to
  81.           _c_l_a_s_s_N_a_m_e  instead  of FFFFrrrraaaammmmeeee.  Changing the class of a frame
  82.           widget may be useful in order to use a special class name in
  83.           database  options referring to this widget and its children.
  84.           Note:  ----ccccllllaaaassssssss is handled differently than other command-line
  85.           options  and  cannot  be specified using the option database
  86.           (it has to be processed before the other  options  are  even
  87.           looked  up,  since the new class name will affect the lookup
  88.           of the other options).  In addition, the ----ccccllllaaaassssssss  option  may
  89.           not be queried or changed using the ccccoooonnnnffffiiiigggg command described
  90.           below.
  91.  
  92.  
  93.      WWWWIIIIDDDDGGGGEEEETTTT CCCCOOOOMMMMMMMMAAAANNNNDDDD
  94.           The ffffrrrraaaammmmeeee command creates a new Tcl command  whose  name  is
  95.           the  same  as  the  path  name  of the frame's window.  This
  96.           command may be used to  invoke  various  operations  on  the
  97.           widget.  It has the following general form:
  98.  
  99.                _p_a_t_h_N_a_m_e _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
  100.           _P_a_t_h_N_a_m_e is the name of the command, which is  the  same  as
  101.           the frame widget's path name.  _O_p_t_i_o_n and the _a_r_gs determine
  102.           the exact behavior of the command.  The  following  commands
  103.           are possible for frame widgets:
  104.  
  105.           _p_a_t_h_N_a_m_e ccccoooonnnnffffiiiigggguuuurrrreeee ?_o_p_t_i_o_n? ?_v_a_l_u_e _o_p_t_i_o_n _v_a_l_u_e ...?
  106.                Query  or  modify  the  configuration  options  of  the
  107.                widget.   If  no  _o_p_t_i_o_n  is  specified, returns a list
  108.                describing all of the available  options  for  _p_a_t_h_N_a_m_e
  109.                (see  TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeIIIInnnnffffoooo for information on the format of
  110.                this list).  If _o_p_t_i_o_n is specified with no _v_a_l_u_e, then
  111.                the  command  returns  a  list describing the one named
  112.                option  (this   list   will   be   identical   to   the
  113.                corresponding  sublist  of  the  value  returned  if no
  114.                _o_p_t_i_o_n is specified).   If  one  or  more  _o_p_t_i_o_n-_v_a_l_u_e
  115.                pairs  are  specified,  then  the  command modifies the
  116.                given widget option(s) to have the given value(s);   in
  117.                this  case the command returns an empty string.  _O_p_t_i_o_n
  118.                may have any  of  the  values  accepted  by  the  ffffrrrraaaammmmeeee
  119.                command.
  120.  
  121.  
  122.      BBBBIIIINNNNDDDDIIIINNNNGGGGSSSS
  123.           When a new  frame  is  created,  it  has  no  default  event
  124.           bindings: frames are not intended to be interactive.
  126.  
  127.  
  128.      Page 2                                          (printed 7/23/95)
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      ffffrrrraaaammmmeeee((((nnnn))))                     TTTTkkkk (((( ))))                      ffffrrrraaaammmmeeee((((nnnn))))
  136.  
  137.  
  138.  
  139.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  140.           frame, widget
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.      Page 3                                          (printed 7/23/95)
  195.  
  196.  
  197.  
  198.